---
title: Hearing Locations
summary: Maintains hearing location reference rows, including location codes, address data, rotation flags, and effective dates.
status: draft
owner: SAIF Doc Gen
last_reviewed: 2026-08-25
---

# Hearing Locations

This screen maintains hearing-location reference data for the LegalMaintenance application. It initializes `clsHearingLocationManager` from [SAIF.Application.Claim.Legal](../libraries/saif-application-claim-legal/overview.md), binds hearing-location rows and location-code lookups, and edits hearing-location business objects supplied by [SAIF.Business.Claim.Legal](../libraries/saif-business-claim-legal/overview.md).

## Entry conditions
- Request to `frmHearingLocation.aspx` in the LegalMaintenance application.

## Fields

| Field | Control type | Purpose | Validation |
| --- | --- | --- | --- |
| `dgLocation.HearingLocationCode` | Infragistics WebDataGrid bound field | Stores the hearing location code for the row. | Drop-down provider loaded from `Manager.LocationCode`. |
| `dgLocation.LocationName` | Infragistics WebDataGrid bound field | Stores the hearing location name. | No explicit page-level validation found in source. |
| `dgLocation.Addr1` | Infragistics WebDataGrid bound field | Stores address line 1. | No explicit page-level validation found in source. |
| `dgLocation.Addr2` | Infragistics WebDataGrid bound field | Stores address line 2. | No explicit page-level validation found in source. |
| `dgLocation.Addr3` | Infragistics WebDataGrid bound field | Stores address line 3. | No explicit page-level validation found in source. |
| `dgLocation.City` | Infragistics WebDataGrid bound field | Stores the city name. | `wdg_CityEditor` mask editor is assigned to the `City` column. |
| `dgLocation.State` | Infragistics WebDataGrid bound field | Stores the state abbreviation. | `Wdg_StateEditor` applies mask `>LL`. |
| `dgLocation.Zip` | Infragistics WebDataGrid bound field | Stores the ZIP code. | `wdg_ZipEditor` applies mask `#####`. |
| `dgLocation.Zip4` | Infragistics WebDataGrid bound field | Stores the ZIP+4 suffix. | `wdg_Zip4Editor` applies mask `####`. |
| `dgLocation.RequiresFullDayFlag` | Infragistics WebDataGrid checkbox field | Marks whether the location requires a full-day setting. | Boolean checkbox input. |
| `dgLocation.RotationFlag` | Infragistics WebDataGrid checkbox field | Marks whether the location participates in rotation scheduling. | Boolean checkbox input. |
| `dgLocation.EffectiveDate` | Infragistics WebDataGrid bound field | Stores the row effective date. | Display format `MM/dd/yyyy`; no explicit page-level validation found in source. |
| `dgLocation.ExpirationDate` | Infragistics WebDataGrid bound field | Stores the row expiration date. | Display format `MM/dd/yyyy`; no explicit page-level validation found in source. |
| `dgLocation.RotationAverageCaseCount` | Infragistics WebDataGrid bound field | Displays the average rotation case count for the location. | Decimal data field; no explicit page-level validation found in source. |
| `hfSelectedRowIndex` | Hidden input | Stores the selected grid row index for client-side row selection state. | Set by `dgLocation_RowSelectionChanged`. |
| `hfGridHeight` | Hidden field | Stores the resized grid height for preference saving. | Saved only when numeric in `SavePrefs`. |
| `hfGridWidth` | Hidden field | Stores the resized grid width for preference saving. | Saved only when numeric in `SavePrefs`. |

## Operations

| Operation | Trigger | Description |
| --- | --- | --- |
| Select row | `dgLocation` RowSelectionChanged | Stores the selected row index in `hfSelectedRowIndex`. |
| Insert hearing location | `SAIFMenuTop.InsertButton` click | Calls `Manager.InsertNewLocation()`, rebinds the grid, and begins edit mode on `HearingLocationCode`. |
| Save hearing locations | `SAIFMenuTop.SaveButton` click | Saves dirty, valid hearing-location rows through `Controller.Write`; otherwise shows validation or no-save messages. |
| Delete hearing location | `SAIFMenuTop.DeleteButton` click | Deletes the selected hearing location row by grid data key, then rebinds the grid. |
| Save grid preferences | `SAIFMenuTop.PrefsSetButton` click | Persists grid column and size preferences using `hfGridHeight` and `hfGridWidth`. |
| Clear grid preferences | `SAIFMenuTop.PrefsClearButton` click | Clears saved grid preferences and shows a confirmation message. |

## Business rules

| Rule ID | Rule | Enforcement | Source |
| --- | --- | --- | --- |
| [BR-APP-001](../application/business-rules.md#br-app-001-ad-group-gated-view-only-mode-controls-toolbar-edits) | Users in view-only mode cannot insert, save, or delete hearing-location rows from this screen. | `Page_Load` disables `DeleteButton`, `InsertButton`, and `SaveButton` when `Manager.IsInViewOnly`. | `LegalMaintenance\frmHearingLocation.aspx.vb:47-53` |
| — | The page only writes hearing-location changes when `Manager.HearingLocationCol` is dirty and valid; otherwise it shows either the no-save message or collection error messages. | `Save` | `LegalMaintenance\frmHearingLocation.aspx.vb:101-116` |
| — | Deletion is attempted only when the hearing-location collection is valid, and the selected row's data key is passed to `Manager.DeleteLocation`. | `Delete` | `LegalMaintenance\frmHearingLocation.aspx.vb:126-133` |

## Infragistics components

| Control ID | Control type | SAIF wrapper | Infragistics base | Purpose |
| --- | --- | --- | --- | --- |
| `dgLocation` | WebDataGrid | Direct Infragistics control (no SAIF wrapper) | `Infragistics.Web.UI.GridControls.WebDataGrid` | Displays and edits hearing-location rows. |
| `dgFirm_MaskEditorProvider_Phone` | MaskEditorProvider | Direct Infragistics control (no SAIF wrapper) | `Infragistics.Web.UI.GridControls.MaskEditorProvider` | Declares a phone-style mask editor provider in the page. |
| `Wdg_StateEditor` | MaskEditorProvider | Direct Infragistics control (no SAIF wrapper) | `Infragistics.Web.UI.GridControls.MaskEditorProvider` | Applies the two-letter state mask. |
| `wdg_ZipEditor` | MaskEditorProvider | Direct Infragistics control (no SAIF wrapper) | `Infragistics.Web.UI.GridControls.MaskEditorProvider` | Applies the five-digit ZIP mask. |
| `wdg_Zip4Editor` | MaskEditorProvider | Direct Infragistics control (no SAIF wrapper) | `Infragistics.Web.UI.GridControls.MaskEditorProvider` | Applies the ZIP+4 mask. |
| `wdg_CityEditor` | MaskEditorProvider | Direct Infragistics control (no SAIF wrapper) | `Infragistics.Web.UI.GridControls.MaskEditorProvider` | Applies the city editor mask. |
| `WebResizingExtender1` | WebResizingExtender | Direct Infragistics control (no SAIF wrapper) | `Infragistics.WebUI.WebResizingExtender` | Captures client-side grid resizing for preference persistence. |

## Navigation

| Target | Trigger | Parameters |
| --- | --- | --- |
| `frmAttorneyProfile.aspx` | Postback when `Session.IsNewSession` is `True` | `msg=Your session has timed out` via `REDIRECTFORTIMEOUT` in `clsLegalMaintenanceAncestor`. |

## Sources
- LegalMaintenance\frmHearingLocation.aspx
- LegalMaintenance\frmHearingLocation.aspx.vb